Publish a video from VDO.Ninja to a WHIP ingestion end-point

⚙️

Advanced options

Setup VDO.Ninja to be a WHIP-ingestion end-point (OBS → VDO)

WHIP endpoint URL: https://whip.vdo.ninja
Your stream token must be unique. Only one person can publish to a token at a time.
For our recommend OBS WHIP encoding settings, for smooth playback, see this guide.
You have to first start VDO.Ninja (GO button) before starting your OBS stream.
Important: Only ONE viewer can connect directly to an OBS WHIP stream.
Need multiple viewers? Use meshcast.io or deploy your own MediaMTX server.
Can't publish WHIP via OBS outside your LAN? Download our patched OBS version [source]

Publish your camera or screen directly to Twitch channel using VDO.Ninja

WHIP publishing to Twitch offers low-latency streaming with dynamic bitrate adaptation

Special Publishing Tools with Twitch support:

Interactive Whiteboard

Draw and annotate live on screen, perfect for tutorials or explanations

Try Whiteboard →
IP Camera Publisher

Stream MJPEG IP camera feeds with VDO.Ninja to Twitch or other platforms

Try IP Camera →
Multi-Guest Mixer

Mix multiple VDO.Ninja guests into a single stream, all in your browser

Try Mixer →

Play a remote video stream available via WHEP

⚙️

Advanced options

Host a VDO.Ninja stream as a WHEP source

The WHEP endpoint for this is https://whep.vdo.ninja/WHEP_TOKEN_HERE

Clear History


More information and options

For more WHIP/WHEP options, tools, services, and documentation, please see:

https://docs.vdo.ninja/steves-helper-apps/whip-and-whep-tooling

For community support

For support, join our Discord server here.

About WHIP/WHEP and MediaMTX Integration

WHIP (WebRTC-HTTP ingestion protocol) and WHEP (WebRTC-HTTP egress protocol) are standardized protocols for WebRTC streaming. This client utilizes VDO.Ninja as the WebRTC layer to provide a powerful and flexible streaming solution.

Using MediaMTX

To easily configure this client for use with MediaMTX, you can use the &mediamtx parameter in the URL. Here's what you need to know:

  • Simply add &mediamtx=domainname to your URL to configure the client for MediaMTX.
  • The default port for MediaMTX is 8889. If you're using the default port, you don't need to specify it.
  • If you're using a non-standard port, include it like this: &mediamtx=domainname.com:443
  • MediaMTX doesn't support stereo=0, so this setting is automatically removed if detected.
  • You can find a detailed guide here for deploying MediaMTX and configuring it for use with VDO.Ninja .

Important Notes

  • Ensure your MediaMTX server is properly configured and accessible.
  • For optimal performance, use a wired internet connection when streaming.
  • Be aware of your bandwidth limitations when configuring video and audio bitrates.
  • Some browsers may have limitations with certain codecs. If you experience issues, try switching to a different codec.
  • For H265 support, you may need to enable it in your browser if not available. See here for help enabling.

Troubleshooting

If you encounter issues:

  • Check your network connection and firewall settings.
  • Ensure your MediaMTX server is running and accessible.
  • Try using different browsers or updating your current browser.
  • Verify that your camera and microphone are properly connected and permitted in your browser settings.

For more detailed information on WHIP and WHEP, visit the IETF WHIP draft and IETF WHEP draft.


About VDO.Ninja

VDO.Ninja is a powerful, free, and open-source platform for live video production. It uses peer-to-peer technology to bring remote cameras into OBS or other studio software, allowing content creators to produce real-time live shows using remote media streams.

Key features of VDO.Ninja include:

  • High-quality, low-latency video streaming
  • Peer-to-peer technology for direct video transfer
  • Ability to turn smartphones into wireless webcams
  • Compatible with OBS and other studio software
  • Free to use with no account required

VDO.Ninja is designed to be serverless, ensuring it can be offered for free while providing increased levels of security and privacy.

Open Source

Both VDO.Ninja and this WHIP/WHEP client are open-source projects. You can find their source code and contribute to their development on GitHub:

We encourage the community to contribute, report issues, and suggest improvements to help make these tools even better for everyone.